CopyFromMemory(Byte[],Int32,RectL) メソッド

指定された領域をメモリから現在のビットマップにコピーします。

シンタックス

Visual Basic
C#

'宣言
 
Public Overloads Sub CopyFromMemory( _
   ByVal memory() As System.Byte, _
   ByVal pitch As System.Integer, _
   ByVal destinationArea As RectL _
)

public void CopyFromMemory( 
   System.byte[] memory,
   System.int pitch,
   RectL destinationArea
)

パラメータ

memory: コピーするデータ。
pitch: srcData に格納されているソースビットマップのストライドまたはピッチ。ストライドは、スキャンライン (メモリ内の 1 行のピクセル) のバイト数です。ストライドは次の数式から計算できます: ピクセル幅 * ピクセルあたりのバイト数 + メモリパディング。
destinationArea: 現在のビットマップにおいて、srcRectで指定された領域がコピーされる領域の左上隅です。

戻り値の型

メソッドが成功すると、S_OK が返されます。それ以外の場合は、HRESULT エラーコードが返されます。

解説

このメソッドは、現在のビットマップのサイズを更新しません。ソースビットマップの内容が現在のビットマップに適合しない場合、このメソッドは失敗します。メモ：このメソッドは形式変換を実行しません。2つのビットマップ形式は一致する必要があります。このメソッドに無効な入力 (無効な宛先四角形など) を渡すと、予期しない結果（画像の歪みやデバイスの障害など）が生じる可能性があります。バッチ内でビットマップがアクティブな場合、このメソッドを呼び出すと現在のバッチがフラッシュされる可能性があります。フラッシュされたバッチが正常に完了しない場合、このメソッドは失敗します。ただし、このメソッドでは、バッチがフラッシュされた描画ターゲットのエラー状態はクリアされません。失敗した System.Int32 とタグの状態は、次回の {{EndDraw}} または {{Flush}} の呼び出し時に返されます。

参照

Bitmap クラス
 Bitmap メンバ
 オーバーロード一覧